home *** CD-ROM | disk | FTP | other *** search
/ Gigarom 4 / Mac Giga-ROM 4.0 - 1993.toast / FILES / BBS / MUBBS / UserList Updater 5:92.SEA / UserList Updater ƒ / HOW TO UPDATE.TXT next >
Encoding:
Text File  |  1992-05-31  |  3.9 KB  |  102 lines  |  [TEXT/EDIT]
  1. How to upgrade to the new userlist modules:
  2.  
  3. IF YOU DON'T READ THIS WHOLE FILE, THEN IT'S YOUR PROBLEM IF YOUR BBS
  4. IS DOWN FOREVER. If you follow directions here, then you can always
  5. go back to what you had before.
  6.  
  7. The reason you need to do this is that ALL MUBBS modules will read the
  8. userlist as a "Btree" type structure from now on (faster name access
  9. across BIG userlists). All NEW versions of MUBBS (1.1.2 and above) will
  10. use Btree and you will need to convert over to the new format anyway.
  11.  
  12. NOTE: If you are STARTING A NEW BBS, then get MUBBS V1.1.2 !! This
  13.       new version has all the updates DONE FOR YOU! You can find it
  14.       on one of the MANY support BBS's or AOL.
  15.  
  16. What this program is going to do is add a file called "userlist.idx"
  17. to your current "user" folder. This is a INDEX file that allows a
  18. Btree module (included here) to read your userlist very fast.
  19.  
  20. It DOES NOT modify your existing userlist file at all.
  21.  
  22. *********************************************************************
  23. IMPORTANT!!!!!!!
  24.  
  25. AFTER YOU START USING THE NEW USERLIST FORMAT,  * DO NOT * EVER, EVER
  26. EDIT YOUR USERLIST WITH A TEXT EDITOR!!!! DO NOT USE ANY OLD USERLIST
  27. "FIXER" OR "CONVERTER" PROGRAMS ON YOUR LIST! (ones that are new and
  28. say they can be used on V1.1.2 or later are of course OK).
  29.  
  30. Use the "sysop" module to EDIT & remove users from now on!!!
  31.  
  32. If you don't know how to access the "sysop" module, then you didn't
  33. to read the directions and "help" files that come with MUBBS!
  34.  
  35. **********************************************************************
  36.  
  37.  
  38. OK here we go....
  39.  
  40.  
  41. DON'T INSTALL THE MODULES YET!!!!!!
  42.  
  43. You should FIRST check your userlist from the  *OLD*  "sysop" function.
  44. Make sure it doesn't have any problems, if it does, you need to repair
  45. it NOW!
  46.  
  47. YOU SHOULD HAVE A BACK UP OF YOUR BBS (and userlist) MADE NOW.
  48.  
  49. I updated my 800K user file just fine using this, so you shouldn't
  50. have any problems.
  51.  
  52. Here's what to do:
  53.  
  54. 1. Place the "Userlist Updater" application into the same folder as MUBBS.
  55.  
  56. 2. Duplicate your "userlist" file (in your "user" folder) so that you
  57.    can go back to what you had if something messes up.
  58.  
  59. 3. Duplicate your "modules" file and place it somewhere safe so that
  60.    you can go back to what you had if something messes up.
  61.  
  62. 4. Run "Userlist Updater". It will create the new "userlist.idx" file
  63.    that's needed by the new modules. IF YOUR LIST IS LONG, IT MAY TAKE
  64.    A WHILE, GO HAVE LUNCH, BUT LET IT RUN!
  65.  
  66. 5. Install the new modules into your "modules" file using resedit.
  67.    YOU ARE REPLACING THE SOME OF THE OLD ONES WITH THESE! Make sure
  68.    you haven't used ID number 152 for SOME OTHER MODULE, the "Btree"
  69.    module is ID # 152 so make sure that ID is open for this upgrade.
  70.  
  71.    NOTE: You are installing/replacing;
  72.          135 "login"
  73.          136 "getuserfield"
  74.          137 "putuserfield"
  75.          150 "sysop"
  76.          152 "Btree"
  77.  
  78. 6. You can check out your instalation by logging in as the sysop
  79.    (like normal) and then going to the "sysop" module and "listing"
  80.    your userlist. It should read ALL your users out without error.
  81.    You can also try the "checkout" function that reads all records.
  82.  
  83. 7. Guess what? you are done....
  84.  
  85. 8. If something goes wrong, go back to what you had and try again. If
  86.    you still have problems, oh well.... (try the MUBBS Echo for help)
  87.  
  88. NOTE:
  89.  
  90. The "sysop" module included here is NEWER than any other sysop module
  91. released to date, please use THIS one (or a newer one) ONLY!
  92. (the Date is 5/30/92).
  93.  
  94. Enjoy!
  95.  
  96.   DISCLAIMER: This program is a test, it may not be fully debugged, USE AT
  97. YOUR OWN RISK ! BY USING THIS PROGRAM CODE, YOU AGREE TO HOLD IT'S AUTHOR
  98. HARMLESS FROM ANY AND ALL LITIGATION ARISING FROM IT'S USE. This program is
  99. not intended for any particular purpose, and especially not any you expect.
  100. It can crash, wipe out your hard drive, and make your life misiberable. Back
  101. up all data before using. YOU HAVE BEEN WARNED ! This program will self destruct if not handled in a caring manner.
  102.